Method of Configuring Managed Entities in 
a Communications Network using Configuration Templates 

Field of the invention 

[01] The invention relates to configuration management in a network management 
5 context, and in particular to methods of configuring large numbers of managed entities 
in a communications network employing configuration templates. 

Background of the invention 

[02] In the field of communications network management a lot of management 
resources are expended in performing configuration management, and in particular for 
1 0 configuring routers in packet-switched communications networks. 

[03] Routers are Open Systems Interconnect (OSI) Layer- 3 (L3) communications 
network entities directing packets between source communications network nodes and 
destination communications network nodes in packet-switched communications 
networks. A typical communications network deployment employs a multitude of 
15 routers of various makes, types and software releases. 

[04] By far, the most common method of configuring a router includes employing 
Command Line Interface (CLI) commands. Unfortunately CLI command sets are not 
standardized and may even vary across a single vendor's equipment portfolio. As a 
result, a lot of resources are being expended in training network management personnel 

20 to be adept at configuring any and all router makes and types, i.e. mastering a huge CLI 
command set the complexity of which increases with each router software release. 
Despite large amounts of resources being expended in training network management 
personnel gaining experience in configuring routers, human error is a further factor 
which can not be ignored particularly when it comes to configuring high capacity 

25 routers. 
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[05] To alleviate the problem of configuring routers, some communications network 
operators employ a group of highly trained analysts to write full equipment 
configuration CLI scripts for each one of a variety of L3 equipment employed in a 
managed communication network. Such complex CLI scripts are then made available 
5 to less highly trained personnel, at least with respect to CLI configuration of L3 
equipment, who execute the scripts on the various L3 equipment as these are required to 
be configured. Although this approach reduces configuration costs by utilizing the 
highly trained analyst expertise only for CLI script creation, it has a disadvantage in 
terms of script re-use. Specifically, the entire CLI scripts must often be customized, by 
10 highly trained analysts who are familiar with software release specific CLI command 
sets/parameters, because typically some of the CLI commands employed are, and have 
parameters that are, software release specific. Manually customizing the entire CLI 
scripts for each router software release is not the most efficient way to re-use the CLI 
scripts as it is time consuming and error prone. 

15 [06] An alternative to using scripts is to fully model a router and associated L3 
objects such as, but not limited to: interfaces, routing protocols, and Internet Protocol 
(IP) links, etc. associated therewith; and then use a Network Management System 
(NMS) to configure the modeled routers and objects associated therewith. This 
approach suffers from a disadvantage of not allowing for easy configuration of new 

20 managed objects because to model the new managed objects and their interactions 
requires changes to the NMS software. 

[07] Modifying NMS software to support the introduction of new managed objects 
via updated router operating software releases of various routing equipment vendors at 
various times, is time-consuming and costly because of the workload required to 
25 implement such changes, testing and distribution of the updated NMS software. 
Furthermore, desiring to keep the number of NMS software updates to a manageable 
level would mean that there would always be a lengthy time lag in providing support for 
the new managed objects between the introduction of the new managed objects by 
router equipment vendors and those supported by the NMS. 

30 [08] Developments towards these ends include a prior art United States Patent 
number 6,463,528 entitled "Method and Apparatus for Simplifying the Configuration of 
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Several Models of Customer Premise Equipment" which issued on October 8th, 2002 to 
Rajakarunanayake et al. which describes automatically configuring various makes and 
models of routers with Internet Protocol (IP) addresses and IP masks at install time. 
Rajakarunanayake et al. teach the use of a single parameterized script that is 
5 automatically populated with stored and user-specified parameters. Employing a single 
configuration script may be adequate for simple router configurations such as providing 
a single setting, however in accordance with the Rajakarunanayake et al. teachings large 
complex scripts have to be employed in configuring other then a single setting on a 
router. Writing complex large configuration scripts must have hard-coded therein 
10 correct sequencing of CLI commands, however the opportunities for re-using such 
complex large scripts are reduced. 

[09] Therefore, means for easily and efficiently configuring numerous routers of 
various makes, models, and software release is required. 

Summary of the invention 

15 [10] In accordance with an aspect of the invention, a script management system is 
provided. A script repository retrievably stores a plurality of parameterized command 
script templates. At least one command specification constituent of a command script 
template specifies a user parameter identifier. A managed entity configuration 
management module populates parameterized command script templates in deriving 

20 corresponding command scripts therefrom. 

[11] In accordance with another aspect of the invention, a managed entity 
configuration human-machine interface provides: entering a user parameter value for 
the user parameter identifier, saving the user parameter value with a repository, 
optionally requesting the user parameter value from repository, optionally retrieving the 
25 user parameter value from the repository, optionally editing the user parameter value, 
and optionally deleting the user parameter value. 

[12] In accordance with a further aspect of the invention, the command script 
template .is stored in the script repository along with a command script template version 
identifier. User parameter values corresponding to command specifications constituent 
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of the command script template are stored in a user parameter set having a user 
parameter set version identifier. The script management system further includes a 
versioning module inspecting the command script template version identifier and the 
user parameter set version identifier to ensure correspondence therebetween. 

5 [13] In accordance with a further aspect of the invention, the managed entity 
configuration management module further includes means for requesting additional user 
parameter values to be entered via the managed entity configuration human-machine 
interface when discrepancies arise between a command script template version identifier 
and a user parameter set identifier. 

10 [14] In accordance with a further aspect of the invention, at least one command 
constituent of the command script template further specifies a network management 
system parameter identifier. The managed entity configuration management module 
further includes means for obtaining a corresponding managed entity parameter value 
from one of a network management system and an network management system 

15 database. 

[15] In accordance with a further aspect of the invention, each command script 
template further includes an associated script execution dependency specification 
identifying at least one command script required to be executed in advance thereof The 
script management system further includes a script sequencer which inspects the script 

20 execution dependency specification of at least one command script derived from a 
corresponding command script template to determine whether an at least one additional 
command script is required to be executed in advance thereof. The submitted and the 
additional command scripts represent an apply list of scripts. The script execution 
dependency specification and the script sequencer enable the use of specific command 

25 script templates in respect of discrete configuration tasks, and script execution 
dependency specified combinations specifying complex communications network 
managed entity configurations tasks. 

[16] In accordance with a further aspect of the invention, the script execution 
dependency specification further includes a script execution dependency table. 
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(17] In accordance with a further aspect of the invention, the managed 
communications network entity configuration management module further submits 
sequenced command scripts to at least one target managed communications network 
entity for execution in configuring thereof. 

5 [18] In accordance with a further aspect of the invention, the script management 
system includes a managed entity configuration human-machine interface having means 
for: target managed entity selection, command script template selection, and 
submission of the command script template selection for configuration of at lest one 
selected target managed entity to the managed communications network entity 
1 0 configuration management module. 

[19] In accordance with a further aspect of the invention, the script management 
system includes an analyst human-machine interface having means for: command script 
template creation, submission of the command script template to the script repository 
for storage, optional retrieval of the command script template, and optional modification 
1 5 of the command script template. 

[20] In accordance with a further aspect of the invention, the analyst human-machine 
interface includes means for: script execution dependency specification. 

[21] In accordance with a further aspect of the invention, the analyst human-machine 
interface includes means for: command script execution authorization specification in 
20 respect of a command script template. 

[22] In accordance with a further aspect of the invention, a recording medium 
including at least one parameterized command script template is provided. 

[23] In accordance with a further aspect of the invention, the recording medium 
further includes a user parameter set. 

25 [24] In accordance with a further aspect of the invention, the recording medium 
includes a parameterized command script template further having an associated version 
specification, and a user parameter set further having an associated version 
specification. 
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[25] In accordance with a further aspect of the invention, the recording medium 
includes a command script template of a plurality of command script templates which 
has a script execution dependency specification specifying a command script derived 
from one other command script template to be submitted for prior execution. 

5 [26] In accordance with a further aspect of the invention, a method of configuring 
communications network a managed entity is provided. At least one parameterized 
script template is selected from a plurality of parameterized script templates based on a 
configuration task to be performed on the managed entity. The parameterized command 
script template is populated with at least one parameter value to derive a command 
10 script in respect of the configuration task. The command script is submitted to the 
managed entity for execution. 

[27] In accordance with a further aspect of the invention, the parameterized command 
script template is populated with user parameters from a stored user parameter set. 

[28] In accordance with a further aspect of the invention, versions of the 
15 parameterized command template and of the user parameter sets are compared in 
populating the parameterized command script template with user parameter values. 
Network management personnel is prompted for missing user parameter values. 

[29] In accordance with a further aspect of the invention, the parameterized command 
script template is populated with a network management system parameter value 
20 obtained from one of a network management system and a network management system 
database. 

[30] In accordance with a further aspect of the invention, a command script template 
further includes a script execution dependency specification specifying command scripts 
required to be executed before the corresponding command script. The method further 
25 includes ordering the plurality of command script templates in the apply list. 

[31] In accordance with yet another aspect of the invention, the method includes 
determining that a script execution dependency specification specifies a command script 
not currently a member of the apply list, and retrieving the corresponding command 
script template from a script repository for inclusion in the apply list. 
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[32] The advantages are derived from a cost-reduced managed entity configuration of 
various diverse makes, models, and software releases in a communications network. 
Expertise of highly trained analysts is employed in a time-efficient manner to write 
discrete parameterized configuration script templates in respect of specific configuration 
5 tasks for maximum re-use, thereby reducing the number of scripts that they are required 
to write. Script execution dependencies and version information associated with script 
templates enable script dependency checking, script version control, and customization 
of scripts for target managed entity reduces exposure to errors in performing managed 
entity configuration tasks. Network management personnel with little or no CLI 
10 command knowledge merely select and populate parameters for scripts required to 
perform required configurations enhancing the cost-effectiveness of configuration 
management. Faster support for new managed entities and features is provided via 
script templates. 

Brief description of the drawings 

15 [33] The features and advantages of the invention will become more apparent from 
the following detailed description of the exemplary embodiment with reference to the 
attached diagrams wherein: 

FIG. 1 is a schematic diagram showing, in accordance with the exemplary 
embodiment of the invention, inter-operating elements implementing a script 
20 management system. 

[34] It will be noted that in the attached diagram like features bear similar labels. 
Detailed description of the embodiments 

[35] Making exemplary reference to FIG. 1 , operational simplifications are sought in 
configuring Command Line Interface (CLI) command configurable managed entities 
25 230 in a managed communications network 220 wherein network management 
personnel is provided with a communications network managed entity CLI 
configuration means which does not require extensive knowledge of CLI commands. 
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[36] In accordance with a preferred embodiment of the invention, a script 
management system 100 for performing operations on parameterized CLI script 
templates 122 to generate managed entity target specific scripts is provided. 

[37] An analyst is provided with an interface, such as but not limited to, a Graphical 
5 User Interface (GUI) 110 which enables the analyst to create 112, save 114, retrieve 
116, modify, delete, etc. specific discrete parameterized CLI command script templates 
122, as well to define script execution dependencies 118, and perhaps to define 
execution authorization contexts. 

[38] Although the invention will be described herein in respect of parameterized CLI 
10 command script templates, the invention is not limited to CLI script template 
specification. The script management system 100 processes parameterized script 
templates into command scripts. The parameterized script templates may be written 
employing other types of (interface command) languages such as, but not limited to: 
Node Management Terminal Interface (NMTI), and Transaction Language 1 (TL1), 
15 extensible Markup Language (XML), etc. 

[39] In accordance with the exemplary embodiment of the invention, a script 
dependency table 126 is associated with each script template 122 to enable proper script 
ordering in configuring a target managed entity. 

[40] In accordance with the exemplary embodiment of the invention, each script 
20 template 122 is written to perform a single discrete managed entity configuration task 
and the corresponding dependency table 126 enables the specification of prerequisite 
scripts which must be executed before the subject script is executed. 

[41] The parameterized CLI command script templates 122 would typically be 
written by highly trained analysts familiar with respective equipment vendors' CLI 
25 command sets; each CLI command employed in a script template having the following 
exemplary format: 

CommandName < UserParamID | valid-range | default-value> / < NMSParamID > . . . 

where CLI command parameters of the type "User Parameter IDentifier" are intended to 
be populated 136 by network management personnel prior to submitting 138 the 
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corresponding CLI command script for execution 232 on the corresponding target 
managed entity 230, with a corresponding value in the "valid range" specified, else the 
"default value" being employed; and CLI command parameters of the type "NMS 
Parameter IDentifier" are intended to be populated 144, upon submission 138, with 
managed entity parameters 212 supplied via a Network Management System (NMS) 
200 exemplary from an NMS DataBase (DB) 210 as will be described herein below. 

[42] The script management system 100 includes an associated script repository 120 
storing parameterized CLI command script templates 122 along with a script version 
specification 124, a script execution dependency table 126, and user parameter sets 128 
each having a version identifier. 

[43] Network management personnel is provided with a managed entity configuration 
Graphical User Interface (GUI) 130 for: 

target entity selection 1 32 via a network map provided 220 by the NMS 200; 
requesting and retrieving script templates in creating an apply list 134; 
creating, storing, requesting, retrieving, editing user parameter sets 136; and 
submitting an apply list for execution. 

[44] In selecting target entities for configuration, the NMS 200 provides 220 network 
maps generated from managed entity instances 216 registered with the NMS 200 and 
relationships 214 therebetween. 

[45] This list of script templates 122 selected for managed entity configuration, is 
hereinafter referred to as an "apply list". The script management system 1 00 enforces 
network management personnel authorizations in selecting script templates 122 for 
inclusion in an apply list. As the script templates 122 in an apply list are populated with 
valid parameters, the apply list prior to actual transmission for execution 232 on the 
target managed entity 230 includes an ordered (sequenced) list of actual CLI commands. 

[46] Having selected at least one script template 122 for inclusion in an apply list, 
network management personnel is presented with the opportunity to specify values for 
user parameters of user parameters sets 128 corresponding to the script template 122. 
Network management personnel therefore prepares a list of actual CLI commands for 



execution on a target managed entity 230 without requiring extensive knowledge of the 
CLI commands. 

[47] The user parameters sets 128 can be stored in, and subsequently retrieved (136) 
from the script repository 120 allowing re-application of scripts using the same user 
5 parameter sets 128 at a later time. Multiple versions of user parameter sets 128 may be 
stored in the script repository 120 for each script template 122. Each apply list is 
submitted 138 for execution via a managed entity configuration management module 
140 of the script management system 100. 

[48] In accordance with information held in the dependency tables 1 26 corresponding 
10 to all script templates 122 in a particular apply list, an script sequencer 150 correctly 
orders (sequences) the resulting CLI command scripts to be executed on target managed 
entities requesting, retrieving, and inserting 152 any additional prerequisite script 
templates 122 not initially selected by the network management personnel. 

[49] In accordance with the exemplary embodiment of the invention, all storage in, 
15 and retrievals from, the script repository 120 are brokered 134, 136, 146 and 152 
through a versioning module 160 which ensures appropriate script template versions 
being applied to each target managed entity 232 in accordance with a make, type, and 
software release thereof, and further ensures appropriate user parameter set versions 
being used to populate the script templates 122. 

20 [50] In accordance with the exemplary embodiment of the invention, in validating 
146 a submitted 138 apply list, the managed entity configuration management module 
140 in combination with the versioning module 160, in finding a discrepancy, 
specifically prompt 148 network management personnel to supply user parameter values 
in respect of inserted script templates 1 22 and for additional command parameters of an 

25 updated CLI command when these are not available in a user parameter set 128 
corresponding to a script template 122 previously employed in configuring a 
corresponding managed entity 232 in accordance with a previous version of the updated 
CLI command. The versioning functionality enables independent script template 122 
modification and ensures the validity of saved user parameter sets 128 being applied to 

30 managed entities 232. 
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[51] Further, when an old version user parameter set 128 is specified for use in 
respect of an updated corresponding script template 122, the script management system 
100: disregards extra user parameters, if any, in the parameter set 1 28. 

[52] Therefore, analysts only need to update relatively short, simple, configuration 
5 task specific CLI command script templates 128 with each managed entity software 
update. Even in respect of an updated managed entity software, network management 
personnel is provided with means to prepare lists of actual CLI commands for execution 
on a target managed entity 230 without the network management personnel requiring 
extensive knowledge of the CLI command sets. 

10 [53] Prior to submitting the apply list for execution, the managed entity configuration 
management module 140 requests and retrieves 142 target managed entity parameters 
212 from the NMS DB 210 associated with the NMS 200 based on NMS ParameterlDs 
specified and populates 144 each script template 122 in the apply list to generate a 
custom CLI command script for each specific target managed entity 232. 

15 [54] In the process of validating the apply list, inserting new script templates 122, 
ordering the script templates 122, populating user parameters with values, populating 
the NMS parameters with values, requesting user parameter values, the network 
management personnel is provided, for inspection, with a correctly ordered 
progressively complete list of CLI commands to be executed in configuring the target 

20 managed entity(ies). 

[55] In submitting scripts for execution on the target managed entity 232, CLI 
command sequences specified in scripts having no script execution dependency table 
entries are submitted for execution first, the rest of the CLI command sequences are 
submitted only after all prerequisite CLI scripts have been executed in accordance with 
25 execute before dependency specifications associated therewith, thereby greatly reducing 
the extent of CLI configuration knowledge the network management personnel is 
required to have. 

[56] Without limiting the invention, it is expected that some CLI script templates 128 
in the script repository 120 may have empty script dependency tables 126; and that 
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some CLI script templates 128 may include CLI commands not requiring any user 
parameters and/or NMS parameters to be specified. 

[57] In accordance with the exemplary embodiment of the invention, a 
communications network operator is provided with the means to configure a diverse set 
5 of CLI configurable managed entities 232 employed in a corresponding managed 
communications network 220 at reduced costs. Further, it enables the communications 
network operator to configure new managed entities and features more quickly than 
employing NMS-based approaches without requiring managed entity modeling to 
provide support for the new features in that an analyst need only change and/or add a 
10 specific CLI script template 128 in respect of the new managed entity and/or feature. 
Managed entity diversity in the communications network 220 is addressed via the 
versioning functionality regardless whether the diversity is found in the make of the 
managed equipment 232, the type, and/or the software release thereof. 

[58] The embodiments presented are exemplary only and persons skilled in the art 
15 would appreciate that variations to the above described embodiments may be made 
without departing from the spirit of the invention. The scope of the invention is solely 
defined by the appended claims. 
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